home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / suprpoly.lzh / suprpoly.doc next >
Text File  |  1990-09-28  |  12KB  |  237 lines
  1.  
  2.  
  3.  
  4.                     T H E   S U P E R P O L Y S C O P E
  5.                     =====   ===========================
  6.  
  7.  
  8.                              by Sterling K. Webb
  9.  
  10.                  Copyright 1990 by SKWare One and S. K. Webb
  11.                 P. O. Box 277 --- Bunker Hill, Illinois 62014
  12.  
  13.  
  14.  
  15.         I suppose the Superpolyscope is a distant descendant of the most
  16. pre-historic of all screen ancestors: PONG!  Ah, yes, sitting in the
  17. Student Union playing just one more game of PONG compulsively after
  18. another even though finals start in just two days...  Sort of a
  19. neanderthal of an algorithm: when you get to the edge of the screen (or
  20. the paddle) BOUNCE off at an angle equal to the one you glided in at. 
  21. Unthought-of were the problems of multiple interception detection, missile
  22. graphics, hardware sprites, bitplanes, and a host of other complexities
  23. that lay ahead; for now, it was just GLIDE and BOUNCE across that fuzzy
  24. little screen. 
  25.  
  26.         The Super Polyscope just bounces along, changing size, direction,
  27. and color in a whirl of cyclic color animation --- you've probably seem
  28. something like it, but the Super Polyscope gives you control of the
  29. working variables so that you create a wide variety of effects on-screen. 
  30. You can alter the size of the step between each printing of the figure,
  31. the way the figures are drawn, the animation palette, even create your
  32. own!
  33.  
  34.         So, SUPRPOLY.PRG turns your Atari into a $1000-dollar lava-lamp!
  35. You can just run it, ignoring the dialog for now.  Flashy, huh? After
  36. you're finished being impressed, press the <Esc> key.  The Super Polyscope
  37. Dialog will come up, full of nifty GEM gadgets.  The Dialog lets you set
  38. the running characteristics of the Super Polyscope.  And here they are:
  39.  
  40.         The STEP data-button sets the pixel interval at which the Poly's
  41. are printed to the screen.
  42.  
  43.         The STAGGER Switch-Box being ON causes the Poly's to move at two
  44. different angles, depending on whether they're getting bigger or smaller. 
  45.  
  46.         BORDER outlines each Poly with a black border which enhances the
  47. geometricity of their pattern.
  48.  
  49.         When RESET is ON, the screen is cleared (the position of the
  50. Poly's is not changed, though) cyclically, after a delay of the number of
  51. seconds specified in the SECONDS data-button.
  52.  
  53.         The CLEAR Switch-Box, when ON, will clear the screen after exiting
  54. from the dialog.  (This resets the timer for the AUTO RESET is it's ON.)
  55.  
  56.         Some combinations of values have unexpected results.  For example,
  57. setting the STEP to one (pixel) while BORDER is ON causes the Poly's to
  58. erase themselves in one direction (since the black border is one pixel
  59. wide also).  Turning STAGGER ON will cause this erasure to be restricted
  60. to only one combination of direction and sizing.  Large values of STEP
  61. print very rapidly, creating backgrounds for slower small-STEP detailing. 
  62.  
  63.         The Radio Buttons "A" through "E" refer to the choice of built-in
  64. palettes.  These palettes are not the only palettes available for the
  65. Super Polyscope, though.  There is also a user-definable palette.  (See
  66. below about the Palette Editor.)
  67.  
  68.         You don't have to stop the action to change the variables of the
  69. program, however; they can be changed "on the fly" from the keyboard. 
  70. Pressing the <Help> key while the Super Polyscope is running will call up
  71. a Help Box which gives all the keyboard commands: the number keys
  72. <1,2,3,4,5,6,7,8,9> set the STEP; the <S,s> keys toggle STAGGER on and
  73. off; <A,a> toggles AUTO RESET; <B,b> toggles the BORDER; the Function keys
  74. switch palettes; and <P,p> calls up the Palette Editor, where a User
  75. Palette can be created.  (When Auto Reset is ON, the time spent in the
  76. dialog, help box, or palette editor is accounted for and the timer
  77. adjusted accordingly.)
  78.  
  79.         The User Palette can have up to 84 (that's 6 by 14 colors) colors
  80. specified.  The cyclical color animation only uses colors 1 through 14. 
  81. Color 0, the screen background, is always black, and color 15, the writing
  82. color, is always white.  If you input less than 84 colors, when you leave
  83. the Palette Editor, the palette will be searched for an "empty" or 0-color
  84. (black).  You will be querried as to whether or not you want the palette
  85. cut off at this point.  (Usually, you do, otherwise all the "empty" colors
  86. would be included in the color rotation and the screen would go blank for
  87. a while!)
  88.  
  89.         The User Palette can only be called up and enforced by pressing
  90. the F10 key while the Super Polyscope is running! If you press the F10 key
  91. before you have installed a User Palette, you will see a single color bar
  92. (red) cycling through the animation; this is just a marker color.  The
  93. Palette Editor can be called up whether the User Palette is the active
  94. palette for the Super Polyscope or not, so to use the palette you have
  95. created, you must press the F10 key after exiting the Editor (or before
  96. entering it). 
  97.  
  98.         The Palette Editor has data-buttons for the red, green, and blue
  99. values of the color number given in the Color Selector data-button.  The
  100. color currently being altered is shown TO THE RIGHT of the Color Selector;
  101. the color previous to it in the sequence of the palette is shown TO THE
  102. LEFT of the Color Selector.  Showing the previous color makes it easy to
  103. input a long sequence of colors smoothly into a cyclical palette. 
  104.  
  105.         The data-buttons for the Color Selector and the RGB values are
  106. modular.  That is, clicking the arrow up from 7 returns you to 0, and
  107. clicking down from 0 puts you at 7, so you're never more than four clicks
  108. away from any RGB value.  The Color Selector is modular to 84, but when
  109. you select the highest color used out of the 84 colors possible, the bell
  110. will sound, making it easy to find the end of a palette sequence. 
  111.  
  112.         The next three buttons are equally straight-forward.  The RESTORE
  113. button resets the entire User Palette to the values it had when the
  114. Palette Editor was entered or to the values in force the last time the
  115. UPDATE button was clicked.  The CLEAR button voids all palette values and
  116. starts you off with a clear slate.  The UPDATE button sets the currently
  117. established values as the RESTORE palette. 
  118.  
  119.         As you can see from the Palette Editor itself, once a User Palette
  120. has been created, it can be SAVE'd to or LOAD'ed from disk.  These Super
  121. Polyscope palettes have a default extent of ".POL" You don't have to type
  122. it in; it will be appended by the program if you leave the extent blank. 
  123.  
  124.         Most of the commands are documented in the program itself, but one
  125. feature that is NOT is the ability to install one of the five inherent
  126. palettes as the user palette.  Then, it can be edited from the Palette
  127. Editor! (The original palette, "A" through "E," remains the same; the copy
  128. is installed under the F10 key.) From the Super Polyscope Dialog, select a
  129. palette "A" through "E" while holding down the <Alt> key, and it will be
  130. copied to the user palette.  (Whatever values were in the user palette
  131. previously will be erased.)
  132.  
  133.         The screen can be cleared at any time simply by pressing any other
  134. key than the valid keyboard commands (the space bar is handy).  If the
  135. AUTO RESET is ON when you clear the screen, its timer will be reset at the
  136. same time.  And lastly, you can exit the Super Polyscope (why would you
  137. want to do that?) by pressing the <Return> or <Undo> key.  You'll be given
  138. a chance to relent or repent (or undo an accidental poke at the keyboard). 
  139.  
  140.         And, as always, enjoy... And, while you're enjoying all this neat
  141. free programming, you might think about getting a copy of one of the best
  142. perforance/price-ratio software bargains ever for the ST! Just in case you
  143. haven't heard about it, here's your chance...
  144.  
  145.  
  146.   =================                                =====================
  147.     PRESS RELEASE                                  SKWare One PO Box 277
  148.    August 30, 1990                                 Bunker Hill, IL 62014
  149.   =================                                =====================
  150.  
  151.  
  152.  
  153.     ANN